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ABSTRACT 

This manual provides newcomers to the PLATO 
computer-assisted instructional system with an introduction to TUTOR, 
the system^s language. It explains the basic commands and specific 
operating instructions and presents a set of seven simple exercises, 
the performance of which serves as an introduction to PLATO for the 
user. Four appendixes are also included: A) Summary of TUTOR 
Commands; B) How to Predict the Operation of a TUTOR Unit; C) Aids 
for Authors; and D) Using the TUTOR Editor. (PB) 
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INTRCDUCTION TO TUTOR 



Writing on the Student's Screen 

TUTOR is the language in which instructional material is 
prepared for the PLATO Computer-based Education System. A 
lesson written in TUTOR consists of a series of statements of 
the form^ 

COMMAND TAG 

where "COMMAND^' represents an operation to be performed by the 
computer and "TAG" represents specific instructions for per- 
forming the operation. For example, PLATO presents information 
to the student by means of a display screen* One TUTOR comjnand 
which permits the author of lesson material to write on the 
student's screen is the -write- command. The "tag" of the 
-write- command is simply the textual material which is to be 
displayed. Thus, 

write How are you? 

would display the message "How are you?" on the student's screen. 
Since it is often necessary to be able to say exactly where 
material is to be displayed, the TUTOR command -at- is also 
available. The statements: 

Jit ^1020 

write How are you? 

specify that writing of the message "How are you?" is to begin 
on the 10th line of the stduent's screen and at the 20th character 
position of that line (a PLATO screen holds 32 lines of up to 64 
characters each). Once a starting position is specified for a 
display the -write- tag may include positioning of subsequent 

lines • Thus, 

at 140 

write PAGE 2 

at 1510 

write This is line 15, 

This is line 16, and 

This is line 17. 



would display the words "PAGE 2" starting on line 1^ character 
position 40^ and would label lines 15 through 17 by displaying 
message contained in the tag of the second WRITE command^ at 
positions 1510^ 1610^ and 1710* 

Note: the -at- coiranand sets e margin a nice feature indeed! 

Using the TUTOR Editor 

A description of the TUTOR editor is included as Appendix D 
of this document. Also, when you are using the editor, assistance 
is available via the -HELP- key. Here, we merely list the steps 
necessary before you start the exercise sets which begin on 
page 3. 

a) Learn the name of the lesson space assigned to you. 

b) Enter the editor (See sign-on procedure in Appendix D. ) 

c) Type your lesson name on the EDIT OPTION page and 
then press -NEXT-. 

c' ) Specify descriptive information about your " 
lesson. (See Appendix D for instruction. ) 
This step is necessary only the first time 
you enter a new lesson. When you have 
finished entering the data requested, press 
-BACK-. 

d) Press -a- on tha LESSON EDIT page. 

d*) Choose a name for your block "a" (This step is 
done only the first time you enter any block) . 

e) Press -i- to begin inserting the text of exercise 1. 
(Be sure the words "INSERT MODE" appear at-^the top of 
your screen.) 

The general pattern for entering each line of TUTOR text is 
as follows: 

1) Type the command . 

2) Press -TAB- key. (located on the left-hand side 
of your keyboard) 

3) Type the tag . 

4) Press -NEXT-. 

5) Repeat steps (1) through (4) for the next line 
of your program. 
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See Appendix D for details on correcting mistakes and r:r 
the various special options available to yo^* 

Exercise Set 1 
1-1. Copy these statements into a block of your lesson. 

COMMAND TAG EXPLANATION 
unit test 

at 101 On line 1, position 1, 

write Upper left write: "Upper left" 

at 153 , On line 1, position 53, 

write Upper right write: "Upper right" 

at 1601 On line 16, position 1, 

write Middle left write: "Middle left" 

at 3201 On line 32, position 1, 

write Lower left write: "Lower left" 

Read this material into the computer's memory and look at it from 
a student's point of view. (Press SHIFT-STOP) 

1-2. Go back into Author Mode (from Student Mode, press SHIFT- 
1 STOP)* Add to the program statements of exercise 1 to do: 

the following: 

- a. In the center of the student *s screen write the 

letter 'X*. 

b. In the lower right corner of the student's screen 
write the words: 

Lower right 

When finished, enter student mode again to check the ~ 
placement of the various messages on the student • s screen 



Questions and Answers 

In the previous exercises you learned a little about using 
TUTOR to write on a student's display screen. Using the -at- 
and -write- commands, you can instruct the computer to present 
a question to the student. For example, the statements: 

at 503 

write Honolulu is in what state? 

would present a question on line 5 of the screen starting at 
position 3. We must now learn to provide the student with a means 
of answering questions and to provide the computer with a — 



means of checking the answers given. 

The presence of an acitivity requiring a student response 
is signaled by the statement: 

arrow 715 

where the tag (715) has exactly the same format and meaning as 

that of an -at- command. When the computer executes such a 

statement, it plots an arrow on the student's screen at the 

stated screen position^ That is where the student's answer will 

appear when he types it. (In the above example, the student's 
answer will start on line 1, position 15.) 

Once the presence of a response-recpiiring activity is 
signaled, we need a way to inform the computer of the response (s) 
to expect. The simplest such statement is one line; 

/ - answer Hawaii 



^gch a statement infbniis the comp^^ answer. When 

Ithe student types a word that mat o^ this statement> 

^e is told that his answer is corjrect. (Eyen if a student: 
misspells 'Hawaii it .will genera^^lly be recognized and under- 
ELned as a misspelling.) ^ 

In summary, a simple question-answer situation is written 
(in TUTOR) like this: 



at 503 

write Honolulu is in what state? 
arrow 715 



answer Hawaii 



On line 5, position 3 
write the question. 
Student' s answer to be 
written oh line 7 
starting at position 15. 
A correct answer. 
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Exercise Set 2 



2-1. Copy this program- 
COMMAND TAG 



urit 
at 

write 



arrow 
answer 



arrow 
answer 



NOTE; 



math 
205 

Answer these problems 
3 + 3 = 
4x3 = 



413 
6 



613 
12 



EXPLANATION 

On line 2, position 5, 
write the directions; 
skip a line; 

write an addition problem^ 

skip a line; 

write a multiplication 

problem. 

Answer to the addition 
problem is 6, and goes 
on line 4, position 13* 

Answer to the multipli- 
cation problem is 12, 
and goes on line 13/ 
postion 9. 



We intend that you skip a line between 
the ins t ru ct ions "to the st uden t s and 
" " the first problem. Also that you skip 

a line between problems. You should 
not leave other blank lines in your 
program. Our samples contain blanks 
lines so that we can fit in the explana- 
tions on the right. Do not copy, those 
blank lines . 

Eiiter student mode (press SHIFT-STOP) and go through it as a 
student. Try various combinations of correct and wrong answers. 
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2-2* One frequently wishes to give replies to a student con- 
tingent upon specific correct or wrong answers. This 
exercise illustrates such a procedure. Add only the 
bracketed lines to the unit from Exercise 2-1 . (The scate- 
ments from Exercise 2-1 are in italics.) 



COMMAND TAG 



EXPLANATION 



unit 
at 

v^te 



(xnswev 

[at 
write 



arrow . 
answer 

Fwrong 

at 
jwrite 



math 
205 

Answer these problems. 

3 -i- S = 

4 X S = 

413 
6 

420 

Very good 



613 
12 

7 

620 

Multiply, do not add* 



Insert this answer Qon- 
tingent writing. When 
student answers correctly, 
congratulate him, putting 
the message on line 4> 
position 20. 



Insert this wrong answer 
contingent writing-fqr 
the multiplication 
problem. If the student 
accidentally adds, tell 
him so; starting the 
message at line 6, 
position 20. 



Now read in (SHIFT-STOP) and go through the exercises as a student. 
Pay particular attention to the way the contingent lines of 
programming work. Be sure on one of your trials to ansv/er the 
multiplication question (4x3= ) with a 
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2-3- 



On occasion, it is desired to have a message show only for 
one question before the answer is given. This is achieved 
by arrow contingent writing. To the material of Exercise 
2-2, make these additions: 



COMMAND TAG 



unit 
at ; 
write 



arrow 

fat 
^write 



answer 
at 

write 



no 
at 

write 



arrow 

[at 
write 



answer 

wrong 

at 

write 



math 
205 

Answer these problems 

3 3 =^ 

4x3=^ 

413 

701 

Take you time 



6 

420 

Very good 



420 

Try again. 



613 
801 

Keep calm. 



12 
7 

620 

Multiply, do not add. 



EXPLANATION 



Arrow contingent writing 
placed on line 1, 
position 1. 



A universal wrong con- 
tingency . No matttier 
what wrong answer is 
given, say, "Tr^^^again. 
On line 4, position 20. 



Arrow contingent writing 
for the multiplication 
question. 



Read in the lesson. (SHIFT-STOP). Observe the two examples of 
arrow contingent writing as well as the wrong answer contingent 
writing. 
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Separating Groups of Operations 

In order to separate groups of operations which are to be 
performed together, the TUTOR commajnd -unit- is used* The 



sequences 



unit 
at 

write 

unit 

at 

write 



one 

201 

Page 1 

two 

201 

Page 2 



will first display the words "Page 1" starting on line 2, 
position 1. When the student presses the key labeled "NEXT" the 
screen will be erased and the material in unit two will be shown. 
The words "Page 2" will appear. The tags of -unit- commands 
prpv^ide names for groups of TUTOR statements. Hence all of the 
"^UTOR statments between the statement "unit one" and the stateH _ 
meht "unit two" are referred to collectively as the "cdntenfes^^^f 
unit one" or simply "unit one. " Similarly all TIITOR statements 
ibetween the statement "unit -two" anxa the next fdllowi^ -uni tf - 
vcommaind are referred to 3is "the contents of unit two" or simply 
"unit two." 



Exercise Set 3 



3-1 • Write a new unit that has the following problems on the 
screen: 

275 X 32 = 
15 X 5 = 

a« Place this unit in the block with the material from 
.Exercise Set 2 (just completed). Immediately after 
the last stfatement of the previous material^ insert 
the statement: 

unit arith2 

b* As an arrow contingency for problem 1, write the 

message: ^ i^^^^^ 

You may use pencil and paper/ ^C^^^ 

c. As an arrow contingency f or problemT 2, write : 

Do this qncT in yqu he^d. 

d. As a universaii wrong C-no- xroiranand) for probleirC;;!^!^ ] 
write: , - 

You liad better use pencil and paper^^^^^: 
Place it near the bottom of the screen. ^ r^^^ 

e. Make up one other answer-type contingency for one q:f^ 
the problems and include it in your program. 
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Sentence Answers 

Many questioning situations require more than a single word 
response. For example, consider an exercise such as: 




What type of figure is this? 



There are several correct responses, including: 

It is a right triangle. 

a rt. triangle. _ ^ 

_ . a right triangular figure 

5^ jTo instroict the- computer to a<:cep€ answers of this type, 
f^Jt]build a sentence checker using thre^^^ words: 

^ .1. Words that^IWST be preset 

;^^r - 2. Words that can safely be IGNORED. ^ _ 

v^^v 3. Words that CAN'T be present to be correct. 

iHgre is a statement that will correctly check answeris to the 
triangle question : 

i answer <It, is, a, the, it's figure, polygon> (right, rt) 
(triangle, triangular) 

first group of words (enclosfed by < > ) consists of those 
%prds that may be ignored. Following this are two groups of 
v^rds enclosed by parentheses. These are the MUST words. Each 

set^^of parentheses encloses a single must-type word together with 
fac^ceptable synonyms. Notice that synonyms are separated by 
Kbbmmas. If no, s yriohyms are listed for a MUST word, parentheses 

are not used . ^ 




I 
I 

i 
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Exercise Set 4 



Here is the complete unit described above. 
COMMAND TAG EXPLANATION 



unit 
figure 



at 

write 

arrow 
answer 



wrong 
at ^ 
write' 



triang 

310,810,825,310 



1105 

What type figure 
is this? 

1305. 

<it, is, a, it ' s, figure, 
polygon> 

(right, rt) (triangle, 
triangular) 

<it, is, a> square 
1501 . _ 

A square has four 
sides. 



Draw the triangle, one 
segment from 310 (line 3, 
space 10) to 810 (line 8, 
space 10), a second seg- 
ment from 810 to 825, 
and a third segment from 
825 to 310. 



The question. 



Start of answer. 



If the student's answer 
includes the word 
'square', give him this 
message. 



c. 



Copy this unit. For ease of viewing as a student, put it 
ahe^<^ of the units containing material from the previous 
exercise sets. 

Read your lesson into the computer memory* (SHIFT-STOP) 
Try the following answer variations, noting the computer's 
response each times 



1. 

ii. 
iii. 
iv. 



it is a triangle, right? 
correct word order) 



(to see response to in- 



it is a right triangel. (to test spelling) 

it is a squair. (to test spelling on a wrong) 

it is a beautiful right triangle. (to see response 
to extraneous words) 
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4-2. Write a new unit that asks the questions: 

What explorer discovered America in 1492? 

What ships were used in his voyage? 

You design the answer provisions for each question. 

Sequencing Units 

The tags of -unit- commands may also serve as "addresses." 
If the author wants his units to be seen by the student in an 
order other than the sequence in which they are written, he may 
alter this sequence by using -next- commands, -next- uses the 
name of a unit as its tag. Here is an example of the use of 
-next-. 

unit one 
next two 
write Page 1 
unit hidden 

write This message will not be seen by the student 
^ unit two 

write Page 2 

The student first sees the words "Page 1" (on line 1, beginning 
at^postipn 101 since no -at- command is given). When the student 
presses -NEJCT-, the screen is erased and the words "Page 2" 
appear. In this example/ the unit named "hidden" is never seen 
by the student. 

The -next- command can also be used to create repetitive 
type exercises as is illustrated in Exercise Set 6. 

Student Initiated Branches 

The -HELP-, -LAB-, and -DATA- keys and the shif ted-HELP, 
shifted-LAB, and shifted-DATA keys do not function for students 
unless they have been enabled by the lesson author. By inserting 
the commands -help-, -lab-, -data-, or -helpl, -labl-, datal-, 
an author enables the corresponding key. The suffix "1" refers 
to the shifted keys. 

The following units show a use of the -HELP- key. Any of 
the other five kf^ys could have been used in precisely the same 
manner. 
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Exercise Set 5 



1. Copy these units into your lesson space. 



COMMAND TAG 



unit 
next 

at 

write' 
help 



arrow 
answer 

unit 

at 

write 
at 

write 



unit 
at 

write 



jef 
mad 

810 

Who was the THIRD 
President of the 
United States? 

hintl 



1210 

<T, Thomas, To!n> 
Jefferson 

hintl 



410 ^ 

He was a Virginian. 

1810 

Press -NEXT- for 
another hint. 

Press -BACK- if you 
would like to an- 
swer the question. 

hint2 

610 

He was also the chief 
author of our Declar- 
ation of Independence- 



EXPLANATION 



unit mad will follow 
when unit jef is com- 
pleted. 



enable the -HELP- kev. 
If a student presses 
-HELP-, show him unit 
hintl. 



These help units merely 
give hints. 

They might have asked 
questions too. 



skip a line 



an -end- command signal 
the end of a sequence 
of help units. 



end 



(NOTE: The program for Exercise 5-1 continues 
on the next page.) 
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unit mad 

at 1810 

write Which President 

followed Jefferson? 
arrow 1210 

specs nocaps Specify that we wish to 

answer <james> madison accept the answer w ith or 

without capitalization* 
With specs nocaps in 
effect, no capitalization 
should appear in the tag 
of the -answer*- commands. 

Try these units as a student. Go through them at least twice, 
once without pushing -HELP-, and once with help. 

5-2. Write one or more help units for unit mad. Place them after 
unit hint2. Check them in student mode. 

Student Variables 

Each terminal has reserved for it a set of 150 computer words 
called Student Variables. These variables are numbered from 1 
through 150. EacK such variable can be thought of as an individ- 
ualized storage location for various .types of information. 

Probably the most important use of the student variables is 
personalized calculation. A simple example of this is the task 
of Jceeping records on the number of problems worked and the 
rivmiber of errors made by each student. For such an application 
we interpret a variable as a storage location for a number. 
When referring to, say, variable 5, and wanting it interpreted 
as a rational number in decimal notation, we call it: 

v5 

Later you will learn to use these same 150 student variables as 
storage locations for alphabetic strings, or as storage locations 
for integers. 



Exercise Set 6 



1. Here is a unit that randomly selects one digit addends for 
a continuous addition drill. An explanation of the lines 
is at the right. 



COMMAND TAG 



EXPIANATION 



unit 
randu 

randu 



at 

show 

write 
show 

write 



next 



adrill 
vl,9 

v2,9 



calc v3 <- vl + v2 



410 
vl,l 

v2.2 



arrow 422 



ansv v3 



adrill 



Randomly select two num- 
bers between and including 
1 and 9; put the first 
number in student vari- 
able vl, the other 
number in v2. 

Calculate correct an- 
swer; put it in student 
variable. v3. 

On 4th line, 10th space 

show first addend; onlv 
1 digit 

then show other addend, 
allowing 2 spaces, one 
to separate the + and 
the numeral 

then write an equal sign 
with a space before it . 
At this stage the stu- 
dent sees something like: 
7 + 8 = 

Include -arrow- to in- 
dicate that a response is 
required and to separate 
display comi^ands jfrom 
response command. 

Check for correct num- 
erical answer, allowing 
no difference from con- 
tents of v3 (the actual 
answer) . 

Repeat the unit. 



a. 



Read in the unit. Work a few problems as a student, noting 
what happens on wrong answers, 
b. To exit this continuous drill, press SHIFT-STOP. 
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6-2. Unit adrill is not very flexible. It gives the student 

no information on how close he is to being correct. Let's 
fix that. 

COMMAND TAG EXPLANATION 



unit adrill 

randu vl^ 9 

randu v2^9 * 

aale v3 ^ vl -f v2 

at 410 ' 

show vlj 1 

write as in Exercise 1 

show v2j 2 

write = 

arrow 42^ 

ansv v3 - _ - 

next adrill 

wrongv v3,l See if student's answer 

is within 1 of the 

^ correct answer (v3) 

write You're off by 1. if so, tell him 

J- wrongv vl x v^ . check for wrong arith- 

metic operation. 

write You are multiplying! tell student. 

T^o For any other incorrect 

answer — 

r write you're way off. tell him. 



Try several problems as student to check the wrong-answer 
contingent messages. 
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The author of a lesson which uses lots of variable can 
easily become confused about which variables he is using for 
each purpose. One aid to remembering the assignment of var- 
iables is to give them mnemonic names. 

The -define- command associates such names with variables 
(or functions of variables). Below we have rewritten unit adrill 
with defined names in place of vl and v2. Change your copy of 
adrill to match ours. 



unit 
define 

randu ' 

randu 

calc 

. at 

show 

write 

show 

write 

arrow 
ansv 
next 

wrongv 
write 

wrongv 

write 

no 

write You're way off. 

Try the new unit adrill as a student, 
precisely as did the first version. 



adrill 
my names 

first=vl/ second =v2 
result=v3 

first, 9 

second/9 

result<-f irst + second 
410 

first, 1 
+ 

second, 2 
422 

result 
adrill 

result, 1 

You're off by 1. 

first X second 

You are multiplying! 



A lesson may contain 
several sets of defines; 
therefore each set is 
given a name. (We've 
used the name "mvnames.") 
Following the set name 
are mnemonic names and 
the variables to which 
they shall refer. 



It should function 



The unit in Exercise 6-2 goes on forever . Let^s change 
it so that after we have worked four problems correctly in 
a row, we end the drill and tell the student how manv 
errors he made* To do this, we need a counter (let's defin<^ 
worked=vlO) for the number of problems worked correctly 
and a counter for the number of errors (use errors-vll). 
However these counters must be set to zero before we begin 
the drill. This requires a new unit before adrill. Also, 
since the define command must preceed any use of the defined 
names, we must move the define commcind into this new unit. 



COMMAND TAG 



EXPLANATION 



unit 
define 



calc 



]ump 



unit 
randu 
vandu 
aalc 



[ 



at 

show 
write 
show 
write 



initial 
my names 

f irst=vl, second=v2 
result=v3 

worked=vlO, errors^vll 
worked - errors <- (S 



adrill 



adrill 
firsts 9 
seaondj 9 

result first -f second 
worked ^ worked + 1 



410 

first, 1 
second, 2 



Set both counter to 
zero. . . ^ 

jump immediatelv to 
unit adrill; do not- 
wait for student to 
press -NEXT-.. The 
student is never aware 
of being in unit initial. 



Increment problem coun- 
ter every time we choose 
a new problem. 
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[ 



arvoD 

ansv 

next 



422 

result 

worked 
report 



4, adrill. 



Remove the old -next- 
conunand. Uce a 
conditional -next-, 
as long as worked - 4 is 
negative, (i.e., worked 
is less than 4) repeat 
the drill. When 
worked -4=0, (i.e., 
worked = 4) unit report 
is next. 



[ 



[ 
[ 



wrongv result j 1 

calc errors errors + 1 
worked <-0 



write You're off by U 

wrongv firsts second 

write You are multiplying I 

calc worked 0 

errors 4- errors + 1 

no 

calc errors errors + 1 
worked 0 



write You're way off* 

unit report 
at 805 

write You correctly worked 
four problems in a 
row. 

Before that you made 
show errors, 2 
at 1210 

write That's all for now. 



as in Exercise 6-2. 

Count an error when off 
by 1. Set problem 
count back to 0 because 
an error was made. 



Reset problem count. 
Count an error. 



Count an error on all 
other wrongs also. Re- 
set problem count to 0. 



* as in Exercise 6-2* 



Report the results 



Number of errors from 
errors. Allowing 2 
character spaces. 



Read in and check all contingencies, including the score keeping. 
(Be sure to make some errors.) 
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6-4. Make a drill lesson with the following characteristics* 
Put it in a new unit ahead of all previous units. 

a. A multiplication drill with the first factor a two 
digit number (i.e., between 10 and 99 inclusive) 
and the second factor a one digit number. 

b. Write the problems in horizontal format (i.e., 
27 X 3 =) . 

c. Count the problems worked and end the drill after 
the 8th problem. 

d. Provide the following information to the student on 
wrong answers : 

i. If within 1 of the correct answer, tell him so. 
ii. If within 10% of the correct answer, say, 
"You' re close. " (Use the statement 

wrongv * 10% 

for this, filling the blank with the name of 
the variable you are using.) 
iii. If the student accidentally adds, tell him he 
has added, and count it as an error, 
iv* On all other errors say, "Try again." 

e. When the drill is finished report the number of errors 
to the student. 

Try the lesson as a student to see that it works as 
described. 

Joined Units 

One frequently writes material that is used in several units. 
Such material might be a graph or other display that is repeated, 
or it might be a large set of answers used for several questions. 
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Of course, the material could be repeated at the point of 
each use. This is usually wasteful of both computer space and 
author time. A more efficient way is to put the material to be 
repeated in an out-of-the-way unit. The -join- command, using 
the name of the out-of-the--way unit as tag, causes the computer 
to act as though the material were inserted at the appropriate 
points . 

The following example illustrates some uses of the -join- 
command. 

unit boxes 

define place, origin=vl 

calc origin f- 915 

join box 

calc origin f- 2030 

join box 



Draw a box at 915. 
Draw a box at 2030. 



Draw a box whose upper 
left corner is specified 
by orgin. 



unit box 

line origin, origin + 200 

line origin + 200, 
origin + 204 

.line origin + 204, . 
origin + 4 

line origin + 4, origin 

In Exercise 6-3 (the addition drill) it would have been 
convenient to use a joined unit instead of thrice repeating the 
lines: 

calc errors errors + 1 
worked 0 

Each occurrence of those two lines could have been replaced by 

join count 

where "count" is the name of a unit included somewhere in the 
lesson having the form: 

unit count 
calc errors «- errors + 1 
worked f- 1^ 



-22- 



Exercise Set 7 

7-1. This exercise illustrates a way to have a set of several 
exercises executed in a different order by each student, 
or by a given student going through them several times. 
Put this in a new unit ahead of all previous units. 

COMMAND 



TAG 

unit start 

define medley , choice=vlO 

at 402 

write Press next to begin 
the drill 

setperm 6 



EXPLANATION 



Add defined names here 
as you find you need 
them. 



An entry unit 

constructs a set of 
integers 1 through 6 
from which draws will 
be made later. 



unit 
randp 



branch 
choice 



jump 



choice, done, done, 
bl,b2,b3,b4,b5,b6 



Randomly select one of 
the integers provided bv 
the -setperm- command 
(without replacement) and 
put it in variable 
choice. When all choices 
are used put zero in 
choice. 

Go immediately to the 
exercise indicated bv 
the value in choice. Do 
not wait for the student 
to press NEXT. 

a. UNIT BI is to be the following exercise, written as shown, 
near the middle of the screen: 

56 

+ 29 

This unit should contain the line: 

next branch 

somewhere before the -arrow- command. Put in whatever answer 
contingencies you wish. 

b. UNIT B2 is to ask the student to name the 49th and 50th states. 
(Include the line: next branch in this unit also). 



c. Units B3 through B6 should be exercises of vcr iesign. 
(Include: next branch in each.) Try to incluJe at 
least one sentence jujginq situation. 

d. Finally/ include th-: .following: 

unit done 
at 503 

write You have finished the Jesc^n. 
end lesson 
Test these six exercise. 

-2. You have now completed 7 exercise sets. In a new unit 
ahead of the previous ones^ build an index which shows 
the student a numbered list of descriptions of the material 
in the various exercise sets. Tell the student to press 
the number of the exercise he wishes to see. Correct 
answers consist of the numbers, each followed by a -jump- 
to the beginning unit of that exercise. Include in your 
index unit the line: 

term index 

This will permit the student to return at an^^ time to the 
index for another choice by pressing the -TERM- key, 
typing the word index, and pressing -NEXT-. 
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Summary of TUTOR Commands 



To be useful this summary must be brief. For more informa- 
tion on the commands (exceptions, special uses, etc.) see the 
various author aids that are available. (See Appendix C.) The 
classification scheme in this list is identical to that in 
lessons aid2 and aid3. 

PRESENTING 



Screen text 
at 

write 
writec 

show 

showo 

showa 

erase 

mode 

inhibit 

size 

rotate 

delay 
char 

plot 
codeout 



specifies starting position of display on 
plasma panel 

displays message on the plasma panel 

displays one of a series of messages con- 
tingent on the value of an expression 

displays the value of a variable (base 10) 
in the specified format 

displays the value of a variable in octal 
notation (base 8) 

displays stored or packed characters from 
variable (s) specified in tag 

erases screen/ selectively or entirely 

specifies terminal writing state 

temporarily disables certain normal actions 
of TUTOR 

changes to line-drawn characters larger than 
normal characters, size specified by tag 

causes line-drawn characters to be written 
at an angle specified in the tag 

permits specification of short output delays 

permits specification of specially designed 
characters for display 

displays special characters specified by 
-char- command 

specifies code sent to terminal to perform 
special display functions 
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Screen graphics 
line 

liner 

figure 

f iguref 

circle 

circleb 
dot 

window 



draws line on screen between locations 
specified in tag 

draws line from last writing location to 
location specified in tag 

draws connected lines from tagl to tag2 to 
tag3...to tagSO locations (coarse grid) 

draws connected lines from tagl, tag2 to 
tag3, tag4 to tag49,tag50 (fine grid) 

draws circle with relevant parameters set 
in tag 

draws broken circle 

plots -single dot on screen at tag location 

delimits area on line-drawn display on 
plasma panel 



Grafpack commands 
origin 

axes 
bounds 

frame 



scalex 
scaley 



locate 
graph 

gline 
gliner 

labelx 

markx 

labely 

marky 

vbar 

hbar 



specifies position for origin? all other 
plotting and writing with grafpack commands 
are relative to origin 

specifies and draws axes , 

establishes boundaries on axes but does not 
draw axes 

draws frame around boundaries specified 
in tag or by previous -axes- or -bounds- 
commands 

specifies maximum (and minimum if given) 
values on axes 

(all subsequent commands are in scaled units) 

similar to -at- but relative to origin and 
in scaled units 

places dot or other specified character 
string at position indicated relative to 
origin and in scaled units 

like -line-, -liner- commands except relative 
to origin and in scaled units 

labels X axis (numbers and tick marks) 

tick marks only 

labels y axis (numbers arid tick marks) 
tick marks only 

draws vertical bar relative to origin, in 
scaled units 

draws horizontal bar relative to origin, in 
scaled unit 
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Non -screen 
slide 

audio 
play 

record 
enable 

disable 

ext 



turns on slide projector and selects slide 
specified in tag 

plays^ audio message specified in tag 

plays back audio recording, with message 
location specifed in tag 

records message at location specified in tag 

allows inputs from external device (e*g./ 
touch panel) 

refuses inputs from external device (e.g., 
touch panel) 

sends value of tag variable to external 
accessory 



Special typing controls 

tabset sets tabs which can be used by student 



copy 



micro 



chars et 



pressing -TAB- key 

specifies string which is to ^ ». copied 
when -COPY- (carat) key is pressed 

specifies micro table definitions used when 
the student presses -MICRO- key and then 
another specified key 

causes character set specified in tag to be 
loaded into terminal memory 



CA^iCULATING 

Basic calculating 
addl 
subl 
zero 
define 

calc 

calcc 

branch 



adds 1 to vari'ible specified in tag 

subtracts 1 from variable specified in tag 

sets variable specified in tag to zero 

permits author to rename a variable or define 
a mathematical function for a lesson 

assigns value of expression on right side of 
assign arrow to TUTOR variable on left 

does one of several possible calculations 
depending on value of an expression 

(not a command) when pl?iced in tag fi-^^ld of 
a continued -calc- permits brancV. to another 
line in the continued -calc- 



Random numbers 
randu 



provides random numbers, sampled with 
replacement 



setperm 
randp 
remove 
modperm 

-special calculating 
clock 

date 
day 

pack 

compute 

find 

search 

move 

movebit 

block 
common 

unloadc 
loadc 



sets up two lists of random permutations of 
integers from 1 through value specified in tag 

selects randomly from setperm list without 
replacement 

reiaoves specified values from one of setperm 
lists 

refills first setperm list with second 
setperm list 



puts alphameric string in tag variable giving 
time on 24 hour clock (not to be confused 
with the system variable "clock") 

puts character string in tag variable for 
current month/day/year 

places in tag variable the number of days 
elapsed since midnight December 31, 1972 
to nearest 10-6 (approximately 
1/10 second) • 

packs specified string, left-justif ied, in 
specified variable 

compiles specified character string, executes, 
and stores result in specified variable 

searches set of variables for specified 
character string in a specified position with- 
in a variable 

searches set of variables for specified 
character string of 10 characters, independ-_ 
ent of position within a variable 

moves one character from one specified 
variable and character position to another 

moves bit(s) from one specified variable and 
bit position to another 

copies set of variables into another- set 

sets up storage space which is accessible to 
all students in a particular lesson 

saves temporary variables in lesson common 

reloads temporary variables from common to 
where they are accessible to students 



SEQUENCING 

Basic sequencing 
unit 
entry 



identifies a section of a lesson 
provides alternate entry point to a unit 
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base 

end 

arrow 

long 

jkey 

start 

stop 



$$ 



resets main sequence 

terminates branch sequence 

places arrow on screen at tag location; 
waits for student response 

sets maximum length of student response 
(default is 79 characters) 

specifies keys which will initiate judging 
in addition to -NEXT- key 

indicates following material is to be 
condensed 

indicates following material is not to be 

condensed in effect up to next -start- 

coiranand, if any 

indicates statement on that line is a comment 

only and is to be ignored by the computer 

(not a command) when placed on same line as 
TUTOR statement indicates that material 
following is a comment 



Author-specified branch 
next 



nextnow 
jump 

goto 

join 
do 

exit 
if error 
jumpout 



permits movement to another unit by pressing 
-NEXT- key (resets base unit if in main 
sequence) 

terminates processing in a unit and makes 
only -NEXT- key active 

causes immediate movement to unit named in 
tag with change of base to that unit (if in 
main sequence) 

causes movement to unit named in tag without 
change of base but without return to original 
unit (for exception see full description) 

causes temporary movement to unit named in 
tag with return to original unit 

causes repeated -join-s of unit named in tag 

permits temmination of -do- or -join- 
sequence 

causes a -goto- to unit in tag if error is 
found in a -calc- 

jump to specified unit in the lesson named 
in the tag 



Student- initiated branch 

help permits branch by pressing -HELP- 

helpl " permits branch l>y pressing shifted -HELP- 

lab permits branch by pressing -LAB- 

labl permits branch by pressing shifted -LAB- 
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data 

datal 

back 

term 

Timing 
pause 

time 

press 

break 

return 



permits branch by pressing -DATA- 

permits branch by pressing shifted -DATA- 

specifies unit entered when -BACK- key is 
pressed 

permits branching to a unit containing 
-term- and the string typed as the tag 



delays execution of rabsequent statements 
(minimum ♦TS second) 

presses -TIME- key after time specified in 
tag 

puts key named in tag into student input 
buffer 

interrupts computer if time-slice is about 
to be exceeded or output-overflow is about 
to occur, 

similar to -break- but interrupts processing 
unconditionally 



JUDGING 

Always end judging 
ok 
no 

ignore 
match 



(no tag) judges ok 
(no tag) judges no 

(no tag) ignores and erases student response 

searches student response for occurence of 
any of key-words listed in tag 



Sometime end judging (m=end if tag matched^ e^end if error 
detected) 



answer 

wrong 

list 

ansv 

wrongv 
ansva 

vocab 
concept 



checks student response against tag (m) 

checks student response against tag (m) 

sets up list of synonyms for judging 
(not executable) 

checks student response against first 
argument in tag, with tolerance set by 
second argument (m) 

same as ansv except for incorrect response 

checks nume:.« ^al or algebraic student re- 
sponse against first argument in tag, with 
tolerance set by second argument (m) 

sets up list of ignorable words and synonymous 
important words (not executable) 

checks student response against tag, using 
vocab list (m) 



(m) 



touch 
store 

storen 

exact 
exactc 



Never end judging 

join 
storea 



specs 
or 

bump 
put 
putd 
open 

close 



Alters judging 
judge 



specifies location of touch square (m) 

calculates numerical value of student re- 
sponse and stores it in variable specified 
in tag (e) 

searches for and evaluates simple niimerical 
expressions in student responses and stores 
result in specified variables (e) 

checks student response with tag for exact 
character string match (m) 

checks student response for exact character - 
string match with one of several arguments in 
the tag contingent upon the value of an 
expression * 



see description under sequencing 

stores characters from student response/ 
left-justified^ in specified variable (and 
succeeding variables^ if necessary) 

permits alteration of judging process 

provides alternative answers to a previous 
judging command 

removes specified characters from student 
response before judging 

replaces one character string in student 
response with another 

similar to -put- but allows any delimiter 
between character strings 

places characters of student response^ one- 



by-one^ in successive variables starting at 
tag variable (right-justified) 

takes characters stored in right-most six 
bits from successive variables and makes 
judging copy for use by judging commands 



( not a judging command) alters previous 
judgment 
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APPENDIX C 
Aids for Authors 



There are several lessons intended to assist authors. They are 
available from any terminal. Some of them are listed below: 



Lesson Name 

(a) graphd 

(b) calcd 

(c) tutor 

(d) aidl 

(e) aid2; aid3 

(f) grafpack 

(g) service 

(h) char set 



Description 

How to write and draw on the screen. 
Includes writing in various sizes, 
drawing lines and circles, etc. 

How to use TUTOR variables to keep 
records and perform calculations. 

Description of the most commonly 
used TUTOR commands. 

General reference on PLATO and 
TUTOR, 

Reference manuals for the TUTOR 
language. 

Reference manual for special graph- 
making commands. 

Helps authors generate complicated 
displays and individual characters. 

Helps authors create new character 
sets , 



Help is also available from the staff of CERL; do not hesitate to 
ask for assistance. 

Announcements about changes in TUTOR and answers to users' questions 
appear in the lesson space called notes, (Enter notes Via the editor, 
not as a student,) You may enter questions in notes. They will usually 
be answered within 24 hours. (The change code is notes,) 



APPENDIX D 

Using the TUTOR Editor 

The editor for TUTOR lessons is itself a TUTOR lesson, and 
has many aids for TUTOR authors incorporated into its structure. 
At critical points, if you become momentarily confused about 
what you may do next, you may usually obtain aid by pushing the 
-HELP- key. Consequently there is little need for a comprehensive 
printed guide to TUTOR editing. This brief note is intended to 
guide new TUTOR authors who have not learned yet what key to 
push to get from "here" to "there". 

SIGNING ON AS AN AUTHOR 

1. When you sit down at the terminal, if the screen is blank, 
or if you see anything except the Press NEXT to Begin 
message, press the -BACK- key until this message appears. 

(If the -BACK- key does not bring you the Press NEXT message, 
press the shifted -STOP- key then press the -BACK- key several 
times.) 

2. Press -NEXT- to go to the SIGN -ON page. 

3. On the SIGN-ON page, type your name and press -NEXT-. Then 
in the space saying "Type Course Name" type instead the word 
"author" (or just "a") and press -NEXT-. Type your own ID 
code (whatever you wish), and push -NEXT- to go to EDIT 
OPTION page. 

TO REQUEST A NEW LESSON 

1. On the EDIT OPTION page, type "request" and press -NEXT-. 
Follow directions on the REQUEST page to get to the NEW 
LESSON page. 

2. On the NEW LESSON page, enter your najne, the name of the 
lesson you wish to create (up to 10 characters), and your 
telephone number. 
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3. Later that day, the machine operator will create the lesson 
for you if you have permission. 

4. You may check to see if your lesson has been created after 
a few hours, by going to the EDIT OPTION page as specified 
in the SIGN-ON procedure, then typing the desired lesson 
name. If you receive a NO SUCH LEoS0J5 message, the lesson 
has not yet been created. Have patience. 



TO SPECIFY DESCRITIV E INFORMATION ABOUT YOUR LESSON 

1, The first time you enter your lesson by typing its name on 
the EDIT OPTION page, you should fill in the descriptive 
data requested on the DATA page. Type the number correspond- 
ing to the datum you wish to enter, type the information 
requested, then push -NEXT-. When you are through with this 
DATA page, push -BACK- to begin editing your lesson on the 
LESSON EDIT page. Type your last name first, (e.g., Bitzer, 
Donald L. ) , so that lessons can automatically be alphabetized 
by authors • names. Data like your name, department, and 
phone number are obvious.. The "change code" is the security 
code someone must use to edit or change the lesson. Make 
sure you remember it or you will not be able to edit your 
own lesson without help from the machine operator 1 ! If you 
leave the "change code" blank, anyone may edit your lesson. 
The "inspect code" is the security ID code anyone must have 
to look at your lesson. If you don't mind who sees it, leave 
it blank. Finish with a brief one-line description of your 
lesson. (You may change any of this data later by entering 
your lesson and pushing -DATA-.) 

2. When you reach the EDIT OPTION page, type the name of your 
lesson and push -NEXT-. You will reach the LESSON EDIT page 
which lists the name of your lesson, the time, and letters 
a-n specifying one or more "blocks" of lesson tr^t contained 
in your lesson. 
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3. When you enter a brand-new lesson (after specifying the 
descriptive data) there will be only one block (labeled "a") 
with approximately 300 words (computer words of 10 character 
codes each) of space in it. 

4. Lessons are divided into blocks to optimize edit time and 
memory space requirements. Each block may contain up to 
about 60 lines of 50 characters each, or (more typically) 
about 100 lines of 30 characters each. 

5. You may give the blocks descriptive names so that you can 
more easily remember what is in which block. Several blocks 
may have the same name if you wish. 

6. TO EDIT A SPECIFIC BLOCK: Push the letter corresponding to 
the block label, and you will be J^aTcen to the BLOCK EDIT page. 

7. TO START A NEW BLOCK: If you wish to start a new block 
AFTER block "a\ push SHIFT-A. You will be sent to the NEW 
BLOCK NAME page where you may enter a name for that block , 
then -you press —NEXT- to go to the BLOCK EDIT page. 

8. TO DESTROY A BLOCK: There is no special option for this. 
The block will automatically disappear when afll text has 
been deleted from it. 

9. TO COPY A^ BLOCK: Use the SAVE option on ^he BLOCK EDIT page, 
. start a new block, and INSERT the SAVE*d lines into the new 

block. 

10* Lessons with many blocks may be split into PARTS because 
there are too many blocks to show on one LESSON page. 
To go to the PART 2 page from PART 1, push the + key. Push 
the - key to return to PART 1 from the PART 2 page. 



EDITING A BLOCK OF LESSON TEXT 

1. The lesson and block name will appear at top left and center 
of the BLOCK EDIT page, along with the space (in compux:er 
words) left in that block. You may enter editing commands 
from the keyboard which will appear on the screen at the 
top left. 
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EDIT COMMANDS (Enter command, then push NEXT) 

f4 roll the display forward (up) 4 lines 

b20 roll the display back (down) 20 lines 

i3 insert new lesson text after line 3 on the screen 

(Important: use TAB key to separate command and tag.) 

r5 replace lesson text starting with line 5 on the 

screen 

d50 delete 50 lines starting from the one at the top 

of the screen 

(to activate this option, you must push SHIFT-HELP) 

sl4 save 14 lines starting from top of screen and put 

in "save buffer". 

is2 insert the "saved" lines after line 2 now on the 

screen. 

u proceed to the next unit and display it starting 

at line 1. 

uwhee proceed to unit "whee" (if it is in this block) 

pnext proceed to first following line containing a 

TUTOR "next" command. Any characters may follow 
the p (e.g.. Pea - proceed to next line which 
starts with "ca") 

xdog search block for the next line containing "dog" 

and bring it to top of screen. (any character 
string may follow the x) The search is "circular" 
through the block. 

or - roll screen up or down one line 

X of T roll screen up or down ten lines 

space continue filling screen with more lines of text 

following the line at which it stopped. 

ll Show 7 lines of text on the screen before stopping. 

(Normal option is 10 on entering lesson) . 

out escape from a major blunder (like deleting too 

much) without transferring edits you have made in 
this block back to disk. 

Pressing NEXT without entering any edit command will repeat 
most previous commands. If no number- ispontej&ed after i,f,b, 
d, or r, a one is understood. Therefore a "f" command by 
itself meanf "fl". 



USING THE COPY AND EDIT KEYS 

1. The -COPY- and -EDIT- keys work as tney do in TUTOR lessons. 

2. The -COPY- key (having a carat on the keycap a) v/ill copy 
into a line being "inserted" or "replaced" from the line 
appearing immediately above it on the screen. Each push of 
the -COPY- key will copy another "word" (any characters 
bounded by spaces or punctuation) into the line being worked 
on. At any point, pushing the SHIFT-COPY key will copy the 
rest of the; line. 

3. The first cTush^-Q f th e -EDIT- key (having a square on the 
keycap) will wipe out the entire line being worked on. 
Successive pushes of -EDIT- will return "words" to that line 
one at a time^ in a fashion similar to the COPY key. 
SHIFT-EDIT copies in the remaining words in the line. 

4. The -ERASE- key erases one character at a time. The SHIFT- 
ERASE key erases one word in the worked-on line at a time. 



TESTING THE LESSON YOU ARE EDITING 

1. Pressing SHIFT -STOP while editing a lesson will condense 
that lesson and send you into the lesson as a student. When 
finished testing your lesson, press SHIFT-STOP to again re- 
turn to editing without passing through the entire sign-on 
sequence again. 

2. If yoii sign on as a student (type "student" or "s" on the 
SIGN-ON page), you may test or demonstrate any lesson by 
typing its name on the TUTOR display page. 

3. To enter the editor from the TUTOR page, type "edit" instead 
of a lesson name. 

4. Press -p- on the LESSON EDIT page to specify which blocks are 
to be condensed and which are not. 



GENERAL INFORMATION 

!• Pressing -BACK- will take you from the BLOCK EDIT to LESSON 
EDIT to EDIT OPTION page to ENTER ID page to TUTOR page to 
Press NEXT to Begin. Back out all the way when finished to 
prevent anyone from using your ID and editing YOUR lesson 
inadvertently. 

2. Pressing -STOP- while text is being displayed will immediately 
stop the display and await a new command. 

3. To request a printout, type "request" on the EDIT OPTION page 
and follow instructions. 

4. If you have comments about the behavior of TUTOR or general 
messages of interest to other authors, type "notes" on the 
EDIT OPTION page and enter your note in the latest Mock, 
just as if you were editing a lesson. 



